package cn.edu.gxu.oas.module.run.service.department;

import java.util.*;
import jakarta.validation.*;
import cn.edu.gxu.oas.module.run.controller.admin.department.vo.*;
import cn.edu.gxu.oas.module.run.dal.dataobject.department.DepartmentDO;
import cn.edu.gxu.oas.framework.common.pojo.PageResult;
import cn.edu.gxu.oas.framework.common.pojo.PageParam;

/**
 * 学院 Service 接口
 *
 * @author 源码
 */
public interface DepartmentService {

    /**
     * 创建学院
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createDepartment(@Valid DepartmentSaveReqVO createReqVO);

    /**
     * 更新学院
     *
     * @param updateReqVO 更新信息
     */
    void updateDepartment(@Valid DepartmentSaveReqVO updateReqVO);

    /**
     * 删除学院
     *
     * @param id 编号
     */
    void deleteDepartment(Long id);

    /**
     * 获得学院
     *
     * @param id 编号
     * @return 学院
     */
    DepartmentDO getDepartment(Long id);

    /**
     * 获得学院分页
     *
     * @param pageReqVO 分页查询
     * @return 学院分页
     */
    PageResult<DepartmentDO> getDepartmentPage(DepartmentPageReqVO pageReqVO);

    /**
     * 获取学院列表
     *
     * @param reqVO 查询条件
     * @return 学院列表
     */
    List<DepartmentDO> getDepartmentList(DepartmentPageReqVO reqVO);
}